home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / Languages / Mops 2.5 / Quick Edit ƒ / Subject Glossary / Strings < prev    next >
Encoding:
Text File  |  1992-11-29  |  3.1 KB  |  77 lines  |  [TEXT/MSET]
  1. STRING    --  : name
  2.     A standard class.  This class is changed radically from Neon! We now keep 
  3.     two offsets into a string - POS and LIM.  POS marks the "current" position, 
  4.     and LIM the "current" end.  Most string operations operate on the substring 
  5.     delimited by POS and LIM, which we call the active part of the string.  We 
  6.     also keep the size of the string (the real size, that is) in an ivar, so 
  7.     that we can get it quickly without a system call.  See also class string+.  
  8. STRING+    --  : name
  9.     A standard class, subclass of string.  Provides many extensions.
  10.  
  11.  
  12. "        Standard delimiter.
  13. &    -- n  : char
  14.     Leave ascii value of next char in stream. Same as ascii.
  15. ."        Will print to the console text delimited by ".
  16. ASCII    -- n  : char
  17.     Leave ascii value of next char in stream. Same as &.
  18. BL    -- 32    A constant.
  19. BLANKS    addr n --
  20.     Fills memory with blanks (ascii 32) starting at addr for n bytes.
  21. RET    -- 13
  22.     A constant, returns ascii value of a carriage return character.
  23. ,"    --    Add text till " to the dictionary.
  24. ,"STR"    --    Adds text delimited by " at the start and end.
  25.  
  26.  
  27. STRING COMPARISONS
  28.  
  29. CASE?    -- b
  30.     A value.  True if case to be significant in comparisons done by CMPSTR and 
  31.     string+ objects (does not affect string objects).  
  32. CMPSTR    addr1 len1 addr2 len2 -- n
  33.     Compares 2 strings.  Case is significant if CASE? is set to true.  Returns: 
  34.     -1 if first string low, 0 if strings are equal, 1 if first string high.  We 
  35.     assume the lengths are both less than 64K.  
  36. $=    addr1 len1 addr2 len2 -- result
  37.     Compares string1 to string2, both given as the first byte of text (addr) 
  38.     and the number of bytes to compare (len).  Essentially used to do 
  39.     alphabetical sorts with a being less than b and so forth, but note that a 
  40.     (ascii 97) still is "less than" B (ascii 66).  Although A will be less than 
  41.     a.  Result = -1 if string1 is less than string2, = 0 if strings are equal, 
  42.     = 1 if string 1 is greater than string2.  A Toolbox call to IUMagString.  
  43.     See IM for complete detail. 
  44. S=    addr1 len1 addr2 len2 -- b
  45.     Case sensitive string comparison, true if equal.
  46.  
  47.  
  48. PASCAL TYPE COUNTED STRINGS
  49.  
  50. >STR255    addr1 len addr2 -- addr2
  51.     Converts text beginning at addr1 for len characters to a str255 type string 
  52.     at addr2.  
  53. BUF255    -- addr    A 256-byte buffer for str255 operations.
  54. COUNT    str255 -- addr len
  55.     Converts a Pascal type string ( str255 ) to the addr len format.
  56. STR255    addr len -- ^buf255
  57.     Converts text beginning at addr for len characters to a str255 type string 
  58.     at buf255, leaving the addr of buf255.  Note that you should use the string 
  59.     right away as the next call to str255 will overwrite the buffer.  
  60.  
  61.  
  62. STRING CONSTANTS
  63.  
  64. SCON    --  : name  text
  65.     Defines a string constant.  Change from Neon: the first nonblank char after 
  66.     the name of the SCON is the delimiter.  So " can be used as usual, but 
  67.     anything else can be used instead, e.g.: scon <name> /string containing " 
  68.     as non-delimiter/   Example:  scon myscon "test" 
  69. INSTEAD    c-old c-new --
  70.     May be used just after a SCON is defined.  Within the SCON, it replaces any 
  71.     occurrences of c-old with c-new.  This operation is useful for creating 
  72.     SCONs containing special characters such as tab.  
  73.  
  74.  
  75.  
  76.  
  77.